home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / dev / m2 / m2_part1.lha / modula / dice / dice.LHA / doc / fdtolib.doc < prev    next >
Text File  |  1991-04-28  |  2KB  |  74 lines
  1.  
  2. dcc/fdtolib                            dcc/fdtolib
  3.  
  4.                 FDTOLIB.DOC
  5.  
  6.                   Matthew Dillon
  7.                   891 Regal Rd.
  8.                   Berkeley, Ca. 94708
  9.                   USA
  10.  
  11.                   dillon@overload.Berkeley.CA.US        --or--
  12.                   uunet.uu.net!overload!dillon
  13.  
  14. SYNOPSIS
  15.     FDTOLIB files/wildcard.fd [-h hdrfile] -o libname [-mr] [-mD] <more_opts)
  16.  
  17.     files/wildcard.fd    specifies one or more files and/or AmigaDOS
  18.             wildcarding that represents the .FD files that
  19.             are to be processed into a library
  20.  
  21.     -h hdrfile        hdrfile is a .H files that #include's all
  22.             prototypes associated with the FD files.  It
  23.             is only used if the -mr option is specified
  24.  
  25.     -o libname        specify output library name
  26.  
  27.     -mr         specify that a REGISTERED call interface library
  28.             is to be generated (for DICE -m[r,R,RR] options),
  29.             else generates a normal stack-args interface
  30.             library.
  31.  
  32.     -mD         specify large-data model, else small-data model
  33.  
  34.     -I include-dir    passed to DCC
  35.  
  36.     -p prefix        Set prefix (currently only for standard generation,
  37.             doesn't work with -mr).  The default is a single
  38.             unscore.  This option is normally used to generate
  39.             _hyper_ tags for dynamic.library
  40.  
  41.  
  42. DESCRIPTION
  43.  
  44.     FDTOLIB will create an amiga standard library out of specified .FD
  45.     files (for example, you can generate most of amiga.lib by using
  46.     the .FD files on your 1.3 Extras disk).
  47.  
  48.     Basically, FDTOLIB will generate one of four types of libraries:
  49.  
  50.     default     small-data model
  51.     -mD        large-data model
  52.     -mr        small-data model + DICE registered parameters entry pts
  53.     -mr -mD     large-data model + DICE registered parameters entry pts
  54.  
  55.     If -mr is used suitable prototypes must be specified with the -h option.
  56.     In this case, FDTOLIB will run DCC with a special option to have it
  57.     generate a register-specification file for it to match up again the
  58.     FD files.
  59.  
  60.     FDTOLIB then proceeds to scan the .FD files, creating temporary
  61.     assembly files in T: and assembling them with DAS, then appending
  62.     them to the output library and deleting the scratch files.    This
  63.     step occurs for each function in each .FD files.
  64.  
  65.     (For faster operation, you will want to make DAS resident for the
  66.     duration)
  67.  
  68.     If -mr was specified, FDTOLIB only generates library entries for
  69.     those routines for which a prototype exists.  At the end of the
  70.     run FDTOLIB will report any routines which existed in the .FD files
  71.     but did not have a prototype.
  72.  
  73.  
  74.